SetControlTextColour

Definition:

SetControlTextColour(control, red, green, blue)

 

Description:

Set the text colour for a control.

 

Platforms:

All

 

Parameters:

control - required

Name of the control whose text colour you want to change.

 

red - required

Value of the red component of the required colour.

Must be an integer in the range: 0 – 255.

 

green - required

Value of the green component of the required colour.

Must be an integer in the range: 0 – 255.

 

blue - required

Value of the blue component of the required colour.

Must be an integer in the range: 0 – 255.

 

Returns:

nothing

 

Notes:

  • The effect of changing the text colour varies depending upon the type of control and the Target Platform:

    • On Android devices you can change the text colour for all controls except Progress Controls.
    • On iOS devices you can change the text colour of all controls except Progress and Slider Controls.
    • On the Windows Universal Platform, you can change the text colour of all controls except Progress and Slider Controls.
    • On the Windows Desktop Platform you can change the text colour of all controls except Slider Controls.

  • With Ink Picture Controls, changing the Text Colour changes the colour of the line drawn by the user. You can use this to provide a palette of colours for the user to choose from in order to allow different colours to indicate different things and to allow for multi-coloured drawings.

    Note that in order to allow multi-coloured lines to be added to the same drawing, between colour changes you effectively have to save the current drawing in a picture format and then reread it back into the control so the user can draw with the next colour. Specifying an output mapping for the control automatically saves the contents to the appropriate current record in a picture format. You can find an example of how to do this in the Wound Assessment app template available from the Community Portal section of our web site:

    https://www.ndl.co.uk/products/.template-library/wound-assessment

    You will need to be a registered user in order to download the template. If you're not registered, please contact NDL's Helpdesk for assistance.